home *** CD-ROM | disk | FTP | other *** search
/ PC World 2006 December / PCWorld_2006-12_cd.bin / v cisle / robocopy / rktools.exe / RCDATA / CABINET / rktools.msi / cmgetcer.txt < prev    next >
Text File  |  2003-04-18  |  3KB  |  122 lines
  1. CMGetCer.dll
  2. ============
  3.  
  4. Parameters 
  5. ----------    
  6. /type     (ProfileType)        0 û Full Access Profile, 1 û Cert Enroll/Bootstrap profile
  7. /name     (ProfileName)        %ServiceName% - Specify the profile name which is running the custom action (CertEnrollProfileName or FullAccessProfileName). Must exactly match the name specified in [Main]
  8. /dir     (Config_Path)        %ServiceDir% - directory where to find the configuration file
  9. /f     (Config_FileName)    configuration filename
  10. /a     (Action)        0 û Check for certificate only. DoesnÆt do any other processing, but determines whether a certificate is present or not. Based on the type of profile (Full Access or Cert Enrollment) it then either exits or stays connected. See functional flow chart for appropriate behavior. 
  11.                 1 û Proceed through custom action normally. Follows normal flow according to the configuration file. Any other value defaults to 1.
  12.  
  13. Usage:
  14.     GetCertificate /type ProfileType /name ProfileName /dir Config_Path /f Config_FileName /a Action
  15.  
  16.  
  17. In CMAK:
  18. Description:
  19.     Name your action
  20.  
  21. Program to run: (Browse for CMGetCer.dll - make sure it gets included in the service profile)
  22.     CMGetCer.dll
  23.  
  24. Parameters:
  25.     GetCertificate /type 0 /name %ServiceName% /dir %ServiceDir% /f configfile.txt /a 1
  26.  
  27. Action-Type:
  28.     Select when you want this action to execute. 
  29.  
  30.  
  31. Run this custom action for:
  32.     Select when this should be run
  33.  
  34. Enable 'Include the custom action program with this service profile.' 
  35. Enable 'Program interacts with the user'
  36.  
  37.  
  38. As an example this is what a .cms file might look like if a profile is configured to run this custom action as a Pre-Tunnel and as a Connect action.
  39.  
  40. [Pre-Tunnel Actions]
  41. 0=profilename\cmgetcer.dll,GetCertificate /type 0 /name %ServiceName% /dir %ServiceDir% /f configfile.txt /a 1
  42. 0&Description=BootStrap - PreTunnel
  43.  
  44. [Connect Actions]
  45. 0=profilename\cmgetcer.dll,GetCertificate /type 0 /name %ServiceName% /dir %ServiceDir% /f configfile.txt /a 1
  46. 0&Description=BootStrap - PostConnect
  47.  
  48.  
  49. Note:
  50. Remember if only one profile is configured, it should be set as (/type 0) Full Access profile and CertEnrollProfileName value in the configuration file must be empty or not present.
  51.  
  52.  
  53. =========================
  54. Sample configuration file
  55. =========================
  56.  
  57.  
  58. [Main]
  59. CertEnrollProfileName=EnrollProfileName
  60. FullAccessProfileName=FullAccessName
  61. EnableCertDetection=1
  62. CertRequestMethod=0
  63. RenewalPeriod=7
  64. ShowUI=1
  65.  
  66.  
  67. [UpdateConfigFile]
  68. CheckForConfigFileUpdate=0
  69. UpdateURL=http://websrv/update/configfile.txt
  70. Version=3
  71.  
  72. [CertDetection]
  73. CertDetectIssuer=0
  74. CertDetectSubject=1
  75. CertDetectUsage=0
  76. CertDetectAltSubject=0
  77. LogicalLocation=0
  78. SystemStore=0
  79. ;SystemStore=1
  80. CaseSensitiveDetect=0
  81.  
  82. [CertDetectIssuer]
  83. CN=SrvRootCA
  84.  
  85.  
  86. [CertDetectSubject]
  87. S=CA
  88.  
  89. [CertDetectAltSubject]
  90. domain.com
  91.  
  92.  
  93. [CertDetectUsage]
  94. 1.3.6.1.5.5.7.3.2
  95.  
  96.  
  97.  
  98. [WebCertEnroll]
  99. EnrollURL=http://websrv/certsrv
  100. CertDetectPollTimeOut=10
  101. CertDetectPollInterval=20
  102. CertDetectSleep=5
  103.  
  104.  
  105. [DirectCertEnroll]
  106. CertServer=Websrv
  107. CertServerCAName=SrvRootCA
  108. GetMachineName=1
  109. CAStore=0
  110. Template=Machine
  111. Usage=1.3.6.1.5.5.8.2.2
  112. CN=Computers
  113. DC=microsoft
  114. DC=org
  115. OU=IT
  116. O=Template
  117. L=City
  118. S=WA
  119. C=US
  120.  
  121.  
  122.